home *** CD-ROM | disk | FTP | other *** search
/ SPACE 2 / SPACE - Library 2 - Volume 1.iso / music / 204a / playit.txt < prev   
Text File  |  1988-04-01  |  10KB  |  208 lines
  1. #########################################################################
  2.  
  3.                         AutoPlay, PLAYIT & PlayEdit
  4.              {ST Replay sound file player & Degas Pic shower}
  5.  
  6.                                  
  7.                            by David R. Sullivan
  8.                               4156 Tolowa Street
  9.                               San Diego, CA 92117
  10.  
  11.                    San Diego Atari Computer Enthusiasts
  12.              ST-SDACE BBS (619)284-3821     2400/1200/300 baud
  13.               SDACE-8 BBS (619)566-3430     1200/300 baud
  14.  
  15. #########################################################################
  16.  
  17.                         This Program is SHAREWARE,
  18.                   it is not to be placed on CompuServe,
  19.                 please contribute if you use this program.
  20.  
  21. #########################################################################
  22.  
  23. You  have  obviously just unARCed the file  PLAYIT.ARC.   The  files  you 
  24. should now have are:
  25.                     AUTOPLAY.PRG (Plays sound files from an AUTO folder)
  26.                     BASCODE.EXE (Michtron's GFA Basic "player" code)
  27.                     PLAYEDIT.PRG (Change .SPL files into .SND files)
  28.                     PLAYIT.PRG ("Click" and play .SND files)
  29.                     PLAYIT.TXT (The file you are reading)
  30.  
  31. NOTE: The file BASCODE.EXE must be in the same folder or "root" directory 
  32. as ANY of the PLAYIT programs (AUTOPLAY.PRG, PLAYEDIT.PRG & PLAYIT.PRG).
  33.  
  34. All programs were written in GFA BASIC and compiled with the GFA COMPILER
  35. from Michtron.  These programs are intended to be used to play back sound 
  36. files created with ST REPLAY sound digitizer, also from Michtron.
  37.  
  38. =========================================================================
  39.                        PLAYEDIT.PRG (AutoPlay Editor)
  40. =========================================================================
  41.  
  42. Raw sound files generated by Michtron's ST REPLAY are saved without any
  43. "speed" data in the file.  Thus, each time you use ST Replay's software
  44. to play back a sound file you must manually "set" the playback speed.
  45.  
  46. To  be  able to just "click and play" sound files required  the  need  to 
  47. include some "speed" data in the sound file.  Thus, PLAYEDIT was born.
  48.  
  49. PLAYEDIT allows you to load in raw digitized .SPL sound files and save
  50. them  with  the  proper "speed" included as  a  .SND  file.   PLAYIT is
  51. designed to only play back these "modified" .SND files.
  52.  
  53. When using PLAYEDIT to modify a .SPL file a single byte is added to the
  54. file in it's conversion to a .SND file.  That is all there is to it.
  55.  
  56. For those who wish to revert back to ST Replay, do not worry.  The extra
  57. byte at the front of the .SND file is virtually ignored by ST Replay.
  58. Just rename the file back to a .SPL file.  It is not good, however, to
  59. continue to convert to .SND files and then rename back to .SPL files, a
  60. buildup of SPEED BYTES will cause some interesting results (unpredictable
  61. sounds).
  62.  
  63. =========================================================================
  64.              PLAYIT.PRG ("Click and Play" .SND file player)
  65. =========================================================================
  66.  
  67. PLAYIT  is a simple "click and play" sound file  player.   Again,  PLAYIT 
  68. only plays .SND sound files that have been modified with PLAYEDIT.
  69.  
  70. =========================================================================
  71.              AUTOPLAY.PRG (Play those sound files at boot-up)
  72. =========================================================================
  73.  
  74. AUTOPLAY will allow you to play and manipulate sound files (.SPL or .SND)
  75. while manipulating DEGAS/NEOchrome pictures.  AUTOPLAY uses a script
  76. file to interpret what you want it to do.  AUTOPLAY can (as the name
  77. suggests) be used from an AUTO folder, it may also be used from any
  78. other folder or directory.
  79.  
  80. It should be noted that a script file is NOT required to use AUTOPLAY.
  81. When AUTOPLAY is run (whether from an AUTO folder or from the desktop)
  82. it looks for a script file in the same "directory" that it is in.
  83. If no script file is found, AUTOPLAY will simply load the first DEGAS/NEO
  84. pic it runs into (if one exists) and then load and play the first .SND
  85. file that it runs into.  AUTOPLAY will NOT play .SPL files without a
  86. script file.
  87.  
  88. This makes AUTOPLAY easy to use without having to create a script file.
  89. Simply convert your favorite .SPL file to a .SND file using PLAYEDIT and
  90. place the .SND file into your AUTO folder on your boot disk along with
  91. AUTOPLAY.PRG, BASCODE.EXE and any favorite PIC you may have.
  92.  
  93. The Commands available in AUTOPLAY's script files are as follows:
  94.  
  95. -------------------------------------------------------------------------
  96.  Command        Example             Comment
  97. -------------------------------------------------------------------------
  98.  REPEAT        /REPEAT 10           Repeat Script File (up to current
  99.                                     command) 10 times                                     
  100.  BUFFER        /BUFFER=2            Set Default Buffer to 2
  101.                /#                   There are five Buffers 0 to 4,
  102.                                     Five for Sound and five for Picture
  103.                                     BUFFER PLAY will set default buffer
  104.                                     here, then execute sound later
  105.  SPEED         /SPEED=2             Set Sound Sampling Speed to 2
  106.                                     in current buffer
  107.  LOAD ONLY     /LOAD ONLY           Load Data into buffer, do not 
  108.                                     view or play data
  109.  VIEW                               View data in default buffer
  110.  BUFFER VIEW   /BUFFER VIEW 1       View data in buffer 1
  111.  SCROLL UP     /SCROLL UP           Scroll default buffer screen up
  112.                                     onto screen
  113.  SCROLL DOWN   /SCROLL DOWN         Scroll default buffer screen down
  114.                                     onto screen
  115.  PLAY          /PLAY                Play sound in default buffer
  116.  BUFFER PLAY   /BUFFER PLAY 1       Play sound in buffer 1
  117.  SOUND         /SOUND 1~2~3~4~5     Equal to GFA BASIC's Sound 1,2,3,4,5
  118.  DELAY         /DELAY 19            Delay 19/60th of a second
  119.  CLEAR         /CLEAR               Clear Screen
  120.  RES           /RES=1               Change to Medium Resolution
  121.                                     0=Low, 1=Medium, 2=High (resets ST)
  122.  GOTO          /GOTO 12             GOTO line number 12
  123.  GOSUB         /GOSUB 50            GOSUB line number 50
  124.  RETURN        /RETURN              Return to last calling point
  125.                                     (Exit a GOSUB)
  126.  PRINT         /PRINT HELLO         Prints HELLO to the screen, the
  127.                                     print command must be last on a
  128.                                     line
  129.  LOCATE        /LOCATE 1~2          Set the new cursor position to 1,2
  130.  END           /END                 Terminates script file
  131.  
  132. -------------------------------------------------------------------------
  133.                           General Line Formats:
  134. -------------------------------------------------------------------------
  135.  
  136.                 [filespec]/COMMAND[/COMMAND][/COMMAND]...
  137.  
  138.                             filespec /SPEED=2
  139.  
  140.                      filespec /LOAD ONLY /SCROLL DOWN
  141.  
  142.                            filespec /LOAD ONLY
  143.  
  144. -------------------------------------------------------------------------
  145.  
  146.      Warning, all commands are interpreted in order as listed above,
  147. regardless of what position they are passed in.  The file(s) are loaded
  148. after the LOAD ONLY command has been searched for.
  149.  
  150.      The Command LOAD ONLY is only useful when use along with a file-
  151. spec.  In all other cases it is ignored.
  152.  
  153.      The filespec command is used to read Sound files and Picture files
  154. from the Disk.  When specified the system will look for the following 
  155. files:
  156.  
  157. filespec.SND    An AutoPlay sound file, with speed control
  158. filespec.SPL    An untouched ST Replay sound file, default speed is 2
  159. filespec.PIx    DEGAS picture, x is the current resolution
  160. filespec.NEO    NEOchrome picture, loaded in LOW RESOLUTION only
  161.  
  162.      When a file is found it will be loaded. If no other parameters are
  163. passed that file will be displayed on the screen or played as a sound
  164. file.
  165.  
  166.      It is best to keep ONE COMMAND per line, or aleast as few as 
  167. possible.  Since all commands are interpreted in a set order, you may
  168. place them anywhere on the line, after the filespec.  Be sure to place
  169. a space character after the filespec so that the system knows where the
  170. end of the filespec is.
  171.  
  172.      To trace a script file as it is executed hold down the right 
  173. mouse button while the AUTOPLAY is loaded.  The Incoming information
  174. will be displayed followed by the filename interpreted by AUTOPLAY.
  175. If you continue to hold the right button, AUTOPLAY will stop at 
  176. each command and wait for you to click the left button (while the
  177. right is being held down).  In trace; NUM: is the buffer number
  178. being accessed, DAT: is the buffer area, SPD: is the current sound
  179. speed and LEN: is the length of the sound.
  180.  
  181. -------------------------------------------------------------------------
  182.                            Example Script File
  183. -------------------------------------------------------------------------
  184.  
  185. EXAMPLE SCRIPT FILE                COMMENT 
  186.  
  187. /PICTURE0 /LOAD ONLY /BUFFER=0     LOAD PICTURE0 INTO P-BUFFER0
  188. /PICTURE1 /BUFFER=1                LOAD PICTURE1 INTO P-BUFFER1 & DISPLAY
  189. /PICTURE2 /LOAD ONLY /BUFFER=2     LOAD PICTURE2 INTO P-BUFFER2
  190. /PICTURE3 /LOAD ONLY /BUFFER=3     LOAD PICTURE3 INTO P-BUFFER3
  191. /SOUND1   /LOAD ONLY /BUFFER=1     LOAD SOUND1 INTO S-BUFFER1
  192. /SOUND2   /LOAD ONLY /BUFFER=2     LOAD SOUND2 INTO S-BUFFER2
  193. /BUFFER VIEW 2                     DISPLAY PICTURE 2
  194. /BUFFER PLAY 1                     PLAY SOUND 1
  195. /BUFFER VIEW 3                     DISPLAY PICTURE 3
  196. /BUFFER PLAY 2                     PLAY SOUND 2
  197. /REPEAT 10                         REPEAT TEN TIMES
  198. /BUFFER=0                          SET DEFAULT BUFFER TO 0
  199. /SCROLL DOWN                       SCRIPT PICTURE 0 DOWN ON THE SCREEN
  200.  
  201.  
  202. -------------------------------------------------------------------------
  203. The file PERFECT.SND (also included in this ARC file) makes a nice
  204. "StartUp" sound file.  Give it a try!
  205.  
  206.  
  207.  
  208.